home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / opusused.arc / OPUSUSED.DOC < prev    next >
Encoding:
Text File  |  1987-05-21  |  7.2 KB  |  136 lines
  1. OPUSUsed v1.0 May 20, 1987
  2. The entire package is Copyright (C)1987 Ricky M. Lively. All rights reserved.
  3.  
  4. In  contrast  to  software firms who attempt to restrict the  distribution  of 
  5. their  products via protection-schemes,  I  encourage free distribution,   and 
  6. trust that those who use my products will pay for them. 
  7.  
  8. Please  keep in mind the fundamental good spirit of free-distribution software 
  9. as  you  endure  the  following barrage of  legalities.    Then  evaluate  the 
  10. outstanding value that OPUSUsed offers you.  I assure you that you will not be 
  11. disappointed. 
  12.  
  13.  
  14. LEGAL TERMS AND CONDITIONS
  15.  
  16. This package is provided to you under the following conditions:
  17.  
  18. 1. You  may copy this entire package,  and give it to anyone who accepts these 
  19.    terms.  The copies you distribute must be complete and unmodified.   You do 
  20.    not have to be registered to distribute this package. 
  21.  
  22. 2. You may execute the programs in this package, in order to evaluate them. If 
  23.    you  decide  that any of this package is of use to you,  you must become  a 
  24.    registered user by sending $10 US to: 
  25.  
  26.       Ricky Lively
  27.       1858 Coral Lane
  28.       Montgomery, AL  36116
  29.       Rick's Place BBS (205)284-9538
  30.  
  31.    Registered users may order update-diskettes (5.25 inch, double density) for 
  32.    $5  US,  plus enough to cover extra postage if you are overseas.   Once you 
  33.    register  for this package,  you are entitled to notification of updates to 
  34.    this package 
  35.  
  36. 3. You may not sell this package to anyone.  If you distribute this package on 
  37.    a diskette,  any fees you collect must be specified as  materials/handling, 
  38.    and may not exceed $5 for the diskette. 
  39.  
  40. 4. You  are completely resposible for determining the fitness or usability  of 
  41.    this package.   I will not be liable for any damages, of any kind,  arising 
  42.    from any failure of any programs in this package to perform as expected. 
  43.  
  44. OPUSUsed v1.0 May 20, 1987
  45. The entire package is Copyright (C)1987 Ricky M. Lively. All rights reserved. 
  46.  
  47. And now on to the documentation...
  48.  
  49. Overview        : OPUSUsed is a Turbo Pascal [1] program that I wrote to  give 
  50.                   me a graphic representation of my BBS usage.  
  51.  
  52. Form            : ╔═════════════════════════════════════════════════════════╗
  53.                   ║                     O P U S U s e d   Version 1.0       ║
  54.                   ╠═════════════════════════════════════════════════════════╣
  55.                   ║                                                         ║
  56.                   ║   [D:][\Path\]OPUSUsed ?                                ║
  57.                   ║      or                                                 ║
  58.                   ║   [D:][\Path\]OPUSUsed Opus.Log [> Opus.Bbs]            ║
  59.                   ║                                                         ║
  60.                   ║   ErrorLevels returned: 1 - Help (this screen)          ║
  61.                   ║                         2 - NO filename supplied        ║
  62.                   ║                         4 - Filename NOT found          ║
  63.                   ║                                                         ║
  64.                   ║     This is a utility to create a log of OPUS usage,    ║
  65.                   ║   One screen line per day.  The Output may redirected   ║
  66.                   ║   to a file, or it will default to the screen.          ║
  67.                   ║                                                         ║
  68.                   ║   By: Ricky M. Lively, Rick's Place BBS (205)284-9538.  ║
  69.                   ║ Copyright (C)1987 Ricky M. Lively. All rights reserved. ║
  70.                   ║                                                         ║
  71.                   ╚═════════════════════════════════════════════════════════╝
  72.  
  73. Output          : ╔══════════════════════════════════════════════════════════╗
  74.                   ║                            1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 ║
  75.                   ║        0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 ║
  76.                   ╠════════╪═══════════╪═══════════╪═══════════╪═══════════╪═╣
  77.                   ║ 18 May │           │           │           │      ▐████│ ║
  78.                   ║ 19 May █ ▐▌      ▐ │  █▌▐███ ▐██ ██ ▐████████████▐▌▐█  │ ║
  79.                   ║ 20 May ▌           │           │           │           │ ║
  80.                   ╠════════╧═══════════╧═══════════╧═══════════╧═══════════╧═╣
  81.                   ║ OPUSUsed v1.0  FROM: 18 May 21:58:11 TO: 20 May  0:01:15 ║
  82.                   ╚══════════════════════════════════════════════════════════╝
  83.  
  84.  
  85. OPUSUsed v1.0 May 20, 1987 
  86. The entire package is Copyright (C)1987 Ricky M. Lively. All rights reserved. 
  87.  
  88. Description     : OPUSUsed writes one  screen line (or file if redirected) per 
  89.                   day logged in the OPUS log.  Five (5) characters are used to 
  90.                   represent the different states of  the board for every half-
  91.                   hour screen position: 
  92.                        ' ' - BLANK    (ASCII x'20').
  93.                              No usage.
  94.                        '│' - TIMELINE (ASCII x'B3').
  95.                              No usage,  this is to give the viewer a reference  
  96.                              point  for the other characters.   A  Timeline is 
  97.                              placed every 6 hours. 
  98.                        '▌' - FIRST15  (ASCII x'DD').
  99.                              Used the first 15  minutes of that half-hour,  no 
  100.                              usage the last 15 minutes. 
  101.                        '▐' - LAST15   (ASCII x'DE').
  102.                              No usage the first 15  minutes of that half-hour, 
  103.                              used the last 15 minutes. 
  104.                        '█' - USED     (ASCII x'DB').
  105.                              Used during the first and last 15 minutes of that 
  106.                              half-hour. 
  107.  
  108. Usage           : Errorlevels  are  returned  to  indicate  abnormal   program 
  109.                   termination: 
  110.                          1 - Returned when you enter the ? to get the  on-line 
  111.                              help screen.  
  112.                          2 - Returned when a filename was not entered.
  113.                          4 - Returned  when  the filename given could  not  be 
  114.                              opened for use. 
  115.                   I  also  use  the DOS Copy command to place  the  redirected 
  116.                   usage  graph  between two text files used as  a  header  and 
  117.                   footer  to  the  graph.   My header  file  usually  has  the 
  118.                   previous  weeks  usage and my footer file has the legend  of 
  119.                   characters used to make the graph. 
  120.  
  121. Files           : OPUSUsed.COM Executable program.
  122.                   OPUSUsed.DOC Documentation.
  123.                   OPUSUse.BAT  Sample batch execution.
  124.                   OPUSUsed.HDR Sample header.
  125.                   OPUSUsed.TRL Sample trailer.
  126.                   BULLETIN.BBS Sample display bulletin.
  127.  
  128. Specification   : Display  - Monochrome or Color Graphics.
  129.                   Memory   - 128Kb.
  130.                   DOS      - 2.0 or later.
  131.                   Storage  - Diskette or Hard disk.
  132.  
  133.  
  134.       [1] Turbo Pascal is a copyrighted product of Borland International.
  135. 
  136.